PATHMac OS 8 Developer Documentation > Networking and Communications > AppleShare >

User Authentication Modules

UAMOpen Command

Your UAM's UAMCall routine is called with a command of UAMOpen after the AppleShare client loads the clietn UAM's code resource. The object name, object zone (if available), Open Transport address, and the server information are passed in. If the connection is already established the sessionRefNum field is filled in; otherwise the value of the sessionRefNum field is 0.

Your UAM must return a 32-bit value named configInfo , which the AFP client interprets as an OSStatus if its value is less than zero. Otherwise, set the bits in configInfo as described in Table 3-2 to indicate the UAM commands that your UAM supports.

Table 3-2 Bit values of configInfo

Bit	Meaning
0	Your UAM provides its own password dialog box
1	Your UAM provides its own volume selection dialog box.
2	Your UAM supports change password
3	Your UAM provides its own change password dialog box
4	Your UAM returns information in the `UAMInfo` field of the `UAMArgs` structure. Please see the note that follows.
5 to 31	Reserved and must be set to zero.

Note

If your UAM does not return information in the UAMInfo field of the UAMArgs structure, the UAMInfo pointer is nil and the AFP client cannot call your UAMCall routine with a command of UAMGetInfo or UAMGetInfoSize ,